home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / ien / ien-132 < prev    next >
Text File  |  1988-12-01  |  22KB  |  808 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                         The CMCC Terminal Process
  9.  
  10.  
  11.                                  IEN 132
  12.  
  13.  
  14.                              1 February 1980
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                              David Flood Page
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                       Bolt, Beranek and Newman Inc.
  37.                             50 Moulton Street
  38.                       Cambridge, Massachusetts 02238
  39.  
  40.  
  41.                               (617) 491-1850
  42.  
  43.     IEN 132           The ARPA CMCC Terminal Process
  44.  
  45.  
  46.  
  47.  
  48.     1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
  49.  
  50.  
  51.     2.  Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  52.  
  53.       2.1  Control commands  . . . . . . . . . . . . . . . . . . . . 5
  54.  
  55.         2.1.1  Gain access control . . . . . . . . . . . . . . . . . 5
  56.  
  57.         2.1.2  Start or stop reports or traps  . . . . . . . . . . . 6
  58.  
  59.         2.1.3  Relinquish control of a gateway . . . . . . . . . . . 7
  60.  
  61.       2.2  Output Commands . . . . . . . . . . . . . . . . . . . . . 7
  62.  
  63.         2.2.1  Find out reports/traps being collected/output . . . . 8
  64.  
  65.         2.2.2  Output selected reports/traps . . . . . . . . . . . . 8
  66.  
  67.         2.2.3  Close the Log File  . . . . . . . . . . . . . . . . . 8
  68.  
  69.       2.3  Database query commands . . . . . . . . . . . . . . . . . 8
  70.  
  71.         2.3.1  Give current Catenet description  . . . . . . . . . . 9
  72.  
  73.       2.4  Other commands  . . . . . . . . . . . . . . . . . . . . . 9
  74.  
  75.         2.4.1  Leave the terminal process  . . . . . . . . . . . . . 9
  76.  
  77.  
  78.     3.  Output Formats . . . . . . . . . . . . . . . . . . . . . . . 9
  79.  
  80.       3.1  Report Outputs  . . . . . . . . . . . . . . . . . . . . . 9
  81.  
  82.         3.1.1  Gateway description . . . . . . . . . . . . . . . .  10
  83.  
  84.         3.1.2  Throughput transit matrix . . . . . . . . . . . . .  10
  85.  
  86.         3.1.3  Echo  . . . . . . . . . . . . . . . . . . . . . . .  10
  87.  
  88.         3.1.4  Status of all interfaces  . . . . . . . . . . . . .  11
  89.  
  90.         3.1.5  Routing data  . . . . . . . . . . . . . . . . . . .  11
  91.  
  92.       3.2  Trap Outputs  . . . . . . . . . . . . . . . . . . . . .  11
  93.  
  94.         3.2.1  Interface up/down . . . . . . . . . . . . . . . . .  11
  95.  
  96.  
  97.  
  98.  
  99.  
  100.                                   - 1 -
  101.  
  102.     IEN 132           The ARPA CMCC Terminal Process
  103.  
  104.  
  105.         3.2.2  Neighbor gateway up/down  . . . . . . . . . . . . .  12
  106.  
  107.       3.3  Messages generated by the control process . . . . . . .  12
  108.  
  109.         3.3.1  Gateway reports time out  . . . . . . . . . . . . .  12
  110.  
  111.         3.3.2  Gateway restarts reporting  . . . . . . . . . . . .  12
  112.  
  113.       3.4  Other displays  . . . . . . . . . . . . . . . . . . . .  12
  114.  
  115.         3.4.1  List reports/traps collected/enabled and output . .  12
  116.  
  117.         3.4.2  Catenet description . . . . . . . . . . . . . . . .  13
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.                                   - 2 -
  160.  
  161.     IEN 132           The ARPA CMCC Terminal Process
  162.  
  163.  
  164.     1.  Introduction
  165.  
  166.          The Catenet Monitoring and Control Center (CMCC)  produces  a
  167.     basic   information  gathering  system  for  the  catenet  and  in
  168.     particular the catenet gateways.  Among the features included are:
  169.  
  170.        - multiple user access to information
  171.        - selective display  of  throughput  and  status  reports  from
  172.          gateways
  173.        - capability of sending specific inquiries to gateways
  174.        - limited status display of the catenet
  175.  
  176.     The   information  gathered  consists  of  throughput  statistics,
  177.     routing information, gateway description and the up/down status of
  178.     each gateway and its interfaces.
  179.  
  180.          The system consists of a control process and a number of user
  181.     terminal processes.  The  control  process  communicates  directly
  182.     with  the  gateways, while the terminal processes communicate with
  183.     the control process.  Each terminal process sends requests to  the
  184.     control  process  to  obtain  information  from  the  gateways and
  185.     displays this information when it is received and can also put the
  186.     information into a log file.  In addition, the terminal  processes
  187.     can  be used to display information stored by the control process.
  188.  
  189.          Users can make requests for gateways to start or stop sending
  190.     regular reports;  to  enable  or  disable  the  sending  of  event
  191.     messages,  known  as  traps;  and to answer single inquiries.  The
  192.     regular reports consist of packet throughput  statistics,  routing
  193.     tables  and  the  up/down status of all interfaces in the gateway.
  194.     Trap types include interface up or down and neighbor gateway up or
  195.     down.  To avoid conflicts, the CMCC prevents more than one user at
  196.     a time from manipulating reports or traps in a gateway.
  197.  
  198.          Using the report and trap information, the CMCC will maintain
  199.     a representation of the up/down status of  all  the  gateways  and
  200.     their  interfaces.   This  representation  can  be  displayed by a
  201.     terminal process.  In addition, the CMCC will generate a  terminal
  202.     alarm whenever it detects that a gateway or interface goes down or
  203.     comes back up.
  204.  
  205.          The  CMCC  is also designed to cope with gateways that do not
  206.     implement all possible monitoring facilities.  In these cases  the
  207.     user  will  be  informed  that  the  gateway could not satisfy the
  208.     information request.
  209.  
  210.          The document describes the use  of  the  Monitoring  terminal
  211.     process  as  it is currently implemented.  It is currently a basic
  212.     information gathering and displaying process, and by and large the
  213.     information gathered is only that which the Satnet  gateways  will
  214.     provide.   New features will be added, and the user interface made
  215.     more sophisticated, as time goes on.  At the moment  there  is  no
  216.  
  217.  
  218.                                   - 3 -
  219.  
  220.     IEN 132           The ARPA CMCC Terminal Process
  221.  
  222.  
  223.     on-line  'help'  facility, so you will need this document with you
  224.     when you start to use the terminal process.
  225.  
  226.          Background information can be found in IEN 105, "ARPA Catenet
  227.     Monitoring  and  Control",  and  IEN  131,   "Gateway   Monitoring
  228.     Protocol",  describes  the  message formats used for communicating
  229.     with the gateways.
  230.  
  231.     2.  Commands
  232.  
  233.          Commands fall into four categories:
  234.  
  235.        - Commands to send messages to the gateways (control commands).
  236.        - Commands to control the output of messages received from  the
  237.          gateways (output commands).
  238.        - Commands  to  interrogate  the   CMCC's   internal   database
  239.          (database commands).
  240.        - Other commands (miscellaneous).
  241.  
  242.          Information sent by the gateways is considered to be either a
  243.     report  or a trap.  A report gives the current value of some data,
  244.     such as throughput counts, in the gateway; a  trap  is  a  message
  245.     announcing  some event in the gateway, such as a network interface
  246.     going down.
  247.  
  248.          The report types available are:
  249.  
  250.        - Gateway description
  251.        - Echo
  252.        - Throughput counts
  253.        - Status of all interfaces
  254.        - Routing table
  255.  
  256.     and the trap types are:
  257.  
  258.        - Interface up/down
  259.        - Neighbor gateway up/down
  260.  
  261.          These are explained more fully in IEN 131.
  262.  
  263.          In the following command format descriptions, square brackets
  264.     denote an optional entry, and curly brackets indicate a list  from
  265.     which  at  least  one  item  must  be  chosen.   Commands  may  be
  266.     abbreviated as long as they are still unique;   however,  spelling
  267.     errors  are  not  allowed,  even  if  the command has already been
  268.     uniquely  specified  before  the  error  was  made.   The  minimum
  269.     abbreviations  are  in  capitals.   A  word  or phrase enclosed in
  270.     angle brackets indicates a variable whose name is to be  supplied,
  271.     for example <gateway name>.  Words not contained in angle brackets
  272.     and having no capitals are noise words and may be omitted.
  273.  
  274.  
  275.  
  276.  
  277.                                   - 4 -
  278.  
  279.     IEN 132           The ARPA CMCC Terminal Process
  280.  
  281.  
  282.          Command input is terminated by a carriage return.  Delete and
  283.     control-A will delete a single character and control-U will delete
  284.     an entire command.  Errors in command input cause self-explanatory
  285.     error  messages to appear, for example BAD GATEWAY NAME.  After an
  286.     error message, all characters (including editing characters) up to
  287.     the next carriage return are ignored.
  288.  
  289.     2.1  Control commands
  290.  
  291.          These are the commands concerned with obtaining  reports  and
  292.     traps  from  the  gateways.   In  order  to start and stop regular
  293.     reports, or enable or disable traps, a terminal process must  have
  294.     access  control  of the gateways affected.  This access control is
  295.     an internal software lock and is not anything  that  the  gateways
  296.     know  about.   A  terminal  process  may directly request a single
  297.     report from a gateway  whether  it  has  access  control  of  that
  298.     gateway  or  not.   These requests go through the control process,
  299.     and it is the control process which actually sends the request  to
  300.     the gateway.
  301.  
  302.     2.1.1  Gain access control
  303.  
  304.          The command
  305.  
  306.         Gain <gateway name>
  307.  
  308.     attempts  to  gain  access  control  of  a  gateway.   If no other
  309.     terminal process has control of the gateway, then the reply
  310.  
  311.          <gateway name> - OK
  312.  
  313.     is given.  If another terminal process does have control, then the
  314.     reply
  315.  
  316.          <gateway name> ALREADY CONTROLLED BY <user name>
  317.  
  318.     will appear.
  319.  
  320.          Examples:
  321.  
  322.          BBN  - OK
  323.  
  324.     and
  325.  
  326.          UCL ALREADY CONTROLLED BY UKSAT
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                                   - 5 -
  337.  
  338.     IEN 132           The ARPA CMCC Terminal Process
  339.  
  340.  
  341.     2.1.2  Start or stop reports or traps
  342.  
  343.        The general form of a control command is:
  344.  
  345.      [NO] {REPort<report>} from{ALL      } [{<n>       }][At <m>]
  346.                    type        {<gateway>}  {Indefinite}
  347.                                   name
  348.  
  349.      [NO] {Trap  <trap  >} from{ALL      }
  350.                   type         {<gateway>}
  351.                                   name
  352.  
  353.      The NO option turns off a report, or disables a trap.
  354.  
  355.      <report type> is one of:
  356.  
  357.        Description           (type 0)
  358.        ECho                       (1)
  359.        Thruput                    (2)
  360.        Allints                    (3)
  361.        Routing                    (7)
  362.  
  363.      and <trap type> is a selection from:
  364.  
  365.        Interface             (type 1)
  366.        Neighbor                   (2)
  367.  
  368.          Report types 4-6 and trap type 3, which are mentioned in  the
  369.     Gateway Monitoring Protocol document, are not implemented yet.
  370.  
  371.          The "from{ALL           }"
  372.                   {<gateway name>}
  373.  
  374.     option  defines  the  gateways  affected.   A  gateway  name is an
  375.     identifier  of  up  to  15  characters.   Gateway  names  may   be
  376.     abbreviated.
  377.  
  378.          <n>
  379.          Indefinite
  380.  
  381.     defines  the number of times the gateway is to produce the report.
  382.     The default is 1.  Indefinite means  until  further  notice,  i.e.
  383.     until a NO REPort command is issued.
  384.  
  385.          At <m>
  386.  
  387.     defines the reporting interval.  The default is 60 seconds.
  388.  
  389.          Example:
  390.  
  391.          REPort Thruput from UCL 25 At 60
  392.  
  393.  
  394.  
  395.                                   - 6 -
  396.  
  397.     IEN 132           The ARPA CMCC Terminal Process
  398.  
  399.  
  400.     turns on a regular report, and
  401.  
  402.           NO Trap Interface from BBN
  403.  
  404.     disables a trap.
  405.  
  406.          If  the  terminal  process  does not have access control of a
  407.     gateway,  then  a  commands  starting  with  NO,   or   containing
  408.     parameters  specifying  a number of reports or reporting interval,
  409.     will cause the message
  410.  
  411.          <gateway name> NOT CONTROLLED
  412.  
  413.     to be output, and the command will be ignored.
  414.  
  415.          The  terminal  process  reports  any  format  errors  in  the
  416.     commands  by self-explanatory error messages, for example BAD TRAP
  417.     TYPE.  It also reports on the results of the requests by  messages
  418.     of the form:
  419.  
  420.        <gateway name>{WILL}<report/trap type(s)>
  421.                      {WONT} [ - TIMED OUT]
  422.  
  423.          "TIMED  OUT"  will  appear if no response at all was obtained
  424.     from the gateway.  The control process tries to obtain a  response
  425.     up  to  three  times  at  30  second intervals before causing this
  426.     message to appear.
  427.  
  428.     2.1.3  Relinquish control of a gateway
  429.  
  430.          To relinquish control of gateways, the command
  431.  
  432.          RELease {<gateway name>}
  433.                  {ALL           }
  434.  
  435.     is entered.  The monitor responds with
  436.  
  437.          <gateway name> - RELEASED
  438.  
  439.     This is to allow  other  users  to  have  access  control  of  the
  440.     gateway.   The Quit command (see below) also releases all gateways
  441.     currently controlled by the terminal process.
  442.  
  443.     2.2  Output Commands
  444.  
  445.          The output commands are concerned with the  information  that
  446.     appears on a terminal, or is output to the log file.  The commands
  447.     available are as follows:
  448.  
  449.        -  Find out which reports/traps are collected/enabled.
  450.        -  Find out which reports/traps are being output.
  451.        -  Output selected reports/traps for selected gateways.
  452.  
  453.  
  454.                                   - 7 -
  455.  
  456.     IEN 132           The ARPA CMCC Terminal Process
  457.  
  458.  
  459.     The  display  outputs  corresponding  to the commands are given in
  460.     section 3.
  461.  
  462.     2.2.1  Find out reports/traps being collected/output
  463.  
  464.        Which {Reports} {Collected}
  465.              {Traps  } {Displayed}
  466.                        {Logged   }
  467.  
  468.          The response to this command is described in  section  3.4.1.
  469.  
  470.     2.2.2  Output selected reports/traps
  471.  
  472.      [NO]{Display}{<report type>}[from{ALL            }]
  473.          {Log    }{<trap   type>}     {<gateway name>}
  474.  
  475.     where  <report  type>  and  <trap type> are named as in the REPort
  476.     command, above and the
  477.  
  478.          "from {ALL            }"
  479.                {<gateway name>}
  480.  
  481.     option indicates the relevant gateways, as in the REPort  command.
  482.     If  there  is  no  log  file open, then a Log command opens a file
  483.     called 'CMCC_LOG.<date>', where <date> is of the  form  22-MAR-80.
  484.     A  NO  Log  comand leaves the log file open, even if the result of
  485.     the command is that nothing is being logged;  closing of  the  log
  486.     file is done by a separate command (see below).
  487.  
  488.          Examples:
  489.  
  490.          Display Thruput from ALL
  491.          NO Log INTerface from UCL
  492.  
  493.     2.2.3  Close the Log File
  494.  
  495.          A "NO Log" command turns off logging for the specified report
  496.     type/gateway  combination,  but  leaves  the  log  file open.  The
  497.     command
  498.  
  499.          UNLog
  500.  
  501.     turns off all logging and closes the log file.
  502.  
  503.     2.3  Database query commands
  504.  
  505.          Currently there is only one of these.
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.                                   - 8 -
  514.  
  515.     IEN 132           The ARPA CMCC Terminal Process
  516.  
  517.  
  518.     2.3.1  Give current Catenet description
  519.  
  520.          The command is
  521.  
  522.      Catenet
  523.  
  524.     and it gives a display of the gateway connections to each network,
  525.     and the status of those connections.  See display 3.4.2.
  526.  
  527.     2.4  Other commands
  528.  
  529.          Currently there is only one of these, too.
  530.  
  531.     2.4.1  Leave the terminal process
  532.  
  533.          The command is
  534.  
  535.          Quit
  536.  
  537.     and it releases any controlled gateways before displaying
  538.  
  539.          STOPPING...
  540.  
  541.     and halting the process. Terminating the process with a  control-C
  542.     will not release controlled gateways and is therefore inadvisable.
  543.     There  is  a separate command to release gateways without halting;
  544.     see section 2.1.3.
  545.  
  546.     3.  Output Formats
  547.  
  548.          There are the following output types:
  549.  
  550.       - Outputs for reports and traps.
  551.       - Outputs for messages generated by the control process.
  552.       - Database query displays.
  553.  
  554.          Each output is preceded by the time expressed as four  digits
  555.     (hhmm).  Any output except the database displays may appear either
  556.     in  the  log  file  or  on  the terminal or both, depending on the
  557.     output commands  that  have  been  entered.   The  information  is
  558.     presented in the same format in both cases.
  559.  
  560.     3.1  Report Outputs
  561.  
  562.          In the following descriptions, <internet address> is the four
  563.     bytes  of an internet address, expressed in decimal, and separated
  564.     by commas.   A  <gateway  name>  may  be  a  character  identifier
  565.     followed  by a slash and a network number, for example "BBN/4", or
  566.     an <internet address>.
  567.  
  568.          Each report has a <sequence number> field of the form  #  50.
  569.     For  regular  reports  this  is the sequence number of the report;
  570.  
  571.  
  572.                                   - 9 -
  573.  
  574.     IEN 132           The ARPA CMCC Terminal Process
  575.  
  576.  
  577.     for a  single  report  it  is  the  report  identification  number
  578.     assigned to the request by the control process.
  579.  
  580.     3.1.1  Gateway description
  581.  
  582.      <gateway name > <sequence number> GATEWAY DESCRIPTION:
  583.      INTERFACES:
  584.          <internet address>,...
  585.      NEIGHBORS:
  586.          <gateway name>,...
  587.  
  588.     where  the "interfaces" list gives the internet address of each of
  589.     the gateway's interfaces.  These are ordered in the same way as in
  590.     the reports.
  591.  
  592.          Example:
  593.  
  594.          RSRE # 0 GATEWAY DESCRIPTION:
  595.          INTERFACES:
  596.               11,3,2,42;  25,6,0,0;
  597.          NEIGHBORS:
  598.               UCL/11
  599.  
  600.     3.1.2  Throughput transit matrix
  601.  
  602.          <gateway name> <sequence number> THROUGHPUT COUNTS:
  603.          TO \ FROM <net name> <net name> DROPPED
  604.          <net name> <count>    <count>    <count>
  605.          <net name> <count>    <count>    <count>
  606.  
  607.          The counts are cumulative counts.
  608.  
  609.          Example:
  610.  
  611.          BBN  # 50 THROUGHPUT COUNTS:
  612.          TO \ FROM  SATNET   ARPANET DROPPED
  613.          SATNET      1         123      5
  614.          ARPANET     13        4        1
  615.  
  616.     3.1.3  Echo
  617.  
  618.        The report is
  619.  
  620.           <gateway name> <sequence number> ECHO HEARD
  621.  
  622.          Example:
  623.  
  624.          NDRE # 4 ECHO HEARD
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.                                   - 10 -
  632.  
  633.     IEN 132           The ARPA CMCC Terminal Process
  634.  
  635.  
  636.     3.1.4  Status of all interfaces
  637.  
  638.     <gateway name><sequence number> INTERFACE TO <net name> {UP  },..
  639.                                                             {DOWN},
  640.  
  641.     for as many network interfaces as necessary.
  642.  
  643.          Example:
  644.  
  645.          COMSAT # 26 INTERFACE TO SATNET UP, COMSAT-NET DOWN
  646.  
  647.     3.1.5  Routing data
  648.  
  649.          <gateway name> <sequence number> ROUTING TABLE:
  650.  
  651.          NETWORK   DISTANCE   GATEWAYS
  652.          NUMBER
  653.           <net>    <hop count>   <gateway name>, <gateway name>,...
  654.  
  655.          This gives, for the gateway, the  minimum  distance  to  each
  656.     network  plus  a  list  of  the neighbor gateway(s) on the minimum
  657.     distance path(s).  If the gateway is known to the CMCC,  then  the
  658.     <gateway name> will be the name, otherwise it will be expressed as
  659.     an <internet address>.
  660.  
  661.          Example:
  662.  
  663.          BBN # 50 ROUTING TABLE:
  664.          NETWORK  DISTANCE  GATEWAYS
  665.          NUMBER
  666.  
  667.            1         2         10,0,0,38;
  668.            4         0
  669.            11        1         UCL/4
  670.  
  671.     3.2  Trap Outputs
  672.  
  673.          There  is  one  output  type  for  each  trap type.  There is
  674.     nothing in a trap message corresponding to the  <sequence  number>
  675.     in a report.
  676.  
  677.     3.2.1  Interface up/down
  678.  
  679.      <gateway name> TRAP MESSAGE: INTERFACE TO <net> {UP  }
  680.                                                      {DOWN}
  681.          Example:
  682.  
  683.          BBN TRAP MESSAGE: INTERFACE TO SATNET DOWN
  684.  
  685.  
  686.  
  687.  
  688.  
  689.                                   - 11 -
  690.  
  691.     IEN 132           The ARPA CMCC Terminal Process
  692.  
  693.  
  694.     3.2.2  Neighbor gateway up/down
  695.  
  696.      <gateway name> TRAP MESSAGE: <Internet address> {UP  }
  697.                                                      {DOWN}
  698.  
  699.          Example:
  700.  
  701.          NDRE TRAP MESSAGE: 10,0,0,38; DOWN
  702.  
  703.  
  704.     3.3  Messages generated by the control process
  705.  
  706.          These messages are to do with gateway reports timing out, and
  707.     coming back up again.
  708.  
  709.     3.3.1  Gateway reports time out
  710.  
  711.      <gateway name> NOT REPORTING.
  712.  
  713.          This  will  be  issued  if  the gateway reports have not been
  714.     received for three minutes.
  715.  
  716.     3.3.2  Gateway restarts reporting
  717.  
  718.      <gateway name> REPORTING AGAIN.
  719.  
  720.          This is issued as soon  as  a  message  is  received  from  a
  721.     gateway that has timed out.
  722.  
  723.  
  724.     3.4  Other displays
  725.  
  726.          These  are  the displays which show information stored at the
  727.     monitoring center.
  728.  
  729.     3.4.1  List reports/traps collected/enabled and output
  730.  
  731.      <report type list> from <gateway name>
  732.      <trap type list> from <gateway name>
  733.  
  734.          These are produced in response to a "Which"...   command,  as
  735.     appropriate.  See section 2.2.1.
  736.  
  737.     Examples:
  738.  
  739.      THRUPUT, ALLINTS FROM BBN
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.                                   - 12 -
  749.  
  750.     IEN 132           The ARPA CMCC Terminal Process
  751.  
  752.  
  753.     3.4.2  Catenet description
  754.  
  755.          The  display  is a matrix showing for each gateway the status
  756.     or existence of its connections to each network.  If a gateway  is
  757.     connected  to  a  network  then  the  matrix entry consists of two
  758.     counts, being the number of interfaces to the  network  which  are
  759.     up,  and  down.   If  there is no connection to a network then the
  760.     entry is a period.
  761.  
  762.                 <net>  <net>  <net>
  763.  
  764.      <gateway>  { UP }   .      .
  765.                 {DOWN}
  766.      <gateway>  - GATEWAY DOWN -
  767.  
  768.     and so on for all gateways.  The "- GATEWAY DOWN -"  display means
  769.     that no regular report has been received from the  gateway  within
  770.     the last three minutes.
  771.  
  772.      Example:
  773.  
  774.                 ARPANET   SATNET  UCLNET
  775.      UCL           .        UP     DOWN
  776.      BBN          UP        UP      .
  777.      NDRE        - GATEWAY DOWN -
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.                                   - 13 -
  808.